home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 October / EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso / Aminet / util / misc / AIS.lha / AIS.readme < prev   
Text File  |  1995-06-21  |  5KB  |  127 lines
  1. Short:    Calculate the total size of an Aminet index
  2. Version:  1.2
  3. Author:   P-O Yliniemi
  4. Uploader: P-O Yliniemi
  5. Type:     util/misc
  6.  
  7. Here is a new version of the GREAT utility AIS. This release
  8. is a bug fix (I really didn't test the previous release in a
  9. REAL low mem situation, just a SIMULATED one).
  10.  
  11. A new argument added, since index files may have the size specifier
  12. at different columns.
  13.  
  14. Usage:
  15.       AIS LISTNAME/A, SIZECOL/N
  16.  
  17.       LISTNAME - name of the list to add all sizes in
  18.  
  19.       SIZECOL  - column with the size specifier ("K", "M" or "?")
  20.                  SIZECOL is optional, and defaults to column 36
  21.                  (ftp.luth.se and maybe others, ftp.wustl.edu = 34).
  22.  
  23. Size:
  24.       1016 bytes! Still below 2 disk blocks!
  25.  
  26. Requirements:
  27.       An Amiga, stack can be as low as 1600 bytes (the
  28.       program uses only 950 bytes of it, but the system
  29.       can't set the stack to a lower value than 1600).
  30.  
  31.       At least 15K mem is required for proper operation.
  32.  
  33.       An Aminet index file (tested with RECENT and INDEX)
  34.       or any other file in the same format ("K", "M" or "?"
  35.       at column 36, size in columns 32-35, formatted as KKKK
  36.       or MM.M). ^^- Now selectable!!!
  37.       
  38. Memory usage:
  39.       Two modes of operation, depending on the amount of
  40.       available memory. Loads the whole index into memory
  41.       if possible.
  42.  
  43.       Both modes:
  44.           13464 bytes to display the requester at end
  45.  
  46.       Fast mode: (index size + stack + 1780 bytes)
  47.          + 1600 bytes for the minimum stack (normally 4k)
  48.          + 1852 bytes for the program and its data
  49.          + a free mem block of at least the size of the index
  50.  
  51.       Slow mode: (stack + 1976 bytes)
  52.          + 1600 bytes for the minimum stack (normally 4k)
  53.          + 2048 bytes for the program and its data
  54.  
  55. History:
  56.  
  57.   1.0 - Coded in ARexx, SLOW! Released 13-Jun-95. Size 3064
  58.         bytes :-(.
  59.  
  60.   1.1 - Rewritten in assembly language (800 times faster).
  61.         Added version string. Released 15-Jun-95. Size:
  62.         936 bytes :-).
  63.  
  64.   1.2 - Low mem bug fix, added command line option, doesn't
  65.         count lines beginning with '|'. Released 22-Jun-95.
  66.         Size 1016 bytes.
  67.  
  68.  
  69. Bugs: Doesn't support Aminet files larger than 99.9M (Aminet
  70.       index file contains space for files up to 9.9M).
  71.  
  72.       Total size must be smaller than 429496729.5K (around
  73.       419430M or 409G). This is smaller than the limit for
  74.       the previously released ARexx version. When Aminet is
  75.       close this size, I will remove this limit (and decrease
  76.       the precision of the calculations).
  77.  
  78.       No more than 4294967295 files can be added to the total
  79.       size (Aminet is now about 17300 files). When Aminet is
  80.       growing towards this limit (in about 90000 years or so),
  81.       I will fix this bug.
  82.  
  83. Speed:
  84.       Tested with the Index file (30-May-95, 1175420 bytes,
  85.       16508 lines). See notes for each test below.
  86.  
  87.       |---------|-------|-----------|-----------|------|---------|
  88.       | Version | Files | Size in K | Size in M | Time | Lines/s |
  89.       |---------|-------|-----------|-----------|------|---------|
  90.       | ARexx   | 16499 | 2551349.2 |    2491.5 | 1610s|    10.2 |  ¹)
  91.       | Asm (F) | 16499 | 2541109.4 |    2481.5 | 2.00s|  8249.5 |  ²)
  92.       | Asm (S) | 16499 | 2541109.4 |    2481.5 |15.08s|  1094.1 |  ³)
  93.       |---------|-------|-----------|-----------|------|---------|
  94.       | Asm (F) | 16499 | 2541109.4 |    2481.5 |19.34s|   853.1 | 68000
  95.       | Asm (S) | 16499 | 2541109.4 |    2481.5 |116.5s|   141.6 | 68000
  96.       |---------|-------|-----------|-----------|------|---------|
  97.  
  98.       ¹) The ARexx version was tested using Edge v1.704. The window
  99.          with the file was as small as possible, all programs that
  100.          could use up some CPU time was disabled (screenblankers etc.)
  101.          The timing was done with a stop watch.
  102.  
  103.       ²) Asm (F) means that there was enough memory to buffer the
  104.          whole file. Timing done using my own hardware-banging timer
  105.          (not released - yet). The timer's precision is around 1/50s.
  106.  
  107.       ³) Asm (S) means SIMULATED low mem situation. The program will
  108.          probably be slower in a real low mem situation. The program
  109.          reads the file line by line when you're almost out of mem.
  110.  
  111.       ** All tests done with an A500+, VXL-030 33MHz/FPU 25MHz, 2M CHIP,
  112.          8M 16-bit mem, and 8M 32-bit mem (around 10.5 * A500).
  113.  
  114. Spoiler:
  115.     Result from Aminet Index (ftp.luth.se) 20-Jun-95:
  116.               Files:      17212
  117.               Size:  2669101.0K
  118.               Size:     2606.5M
  119.  
  120. -----------------------------------------------------------------------------
  121.  
  122.                         Per-Olof Yliniemi
  123.                         Muoniovaara
  124.                         S-980 64 Muodoslompolo
  125.                         SWEDEN
  126.  
  127.